home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / dev / gcc / ixemulsdk.lha / man / cat3 / strtod.0 < prev    next >
Text File  |  1992-08-10  |  2KB  |  67 lines
  1.  
  2. STRTOD(3)                  UNIX Programmer's Manual                  STRTOD(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttoodd - convert ASCII string to double
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddlliibb..hh>>
  9.  
  10.      _d_o_u_b_l_e
  11.      ssttrrttoodd(_c_o_n_s_t _c_h_a_r _*_n_p_t_r, _c_h_a_r _*_*_e_n_d_p_t_r)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ssttrrttoodd() function converts the initial portion of the string pointed
  15.      to by _n_p_t_r to _d_o_u_b_l_e representation.
  16.  
  17.      The expected form of the string is an optional plus (``+'') or minus sign
  18.      (``¡'') followed by a sequence of digits optionally containing a decimal¡
  19.      point character, optionally followed by an exponent.  An exponent con¡
  20.      sists of an ``E'' or ``e'', followed by an optional plus or minus sign,
  21.      followed by a sequence of digits.
  22.  
  23.      Leading white¡space characters in the string (as defined by the iss¡
  24.      pace(3) function) are skipped.
  25.  
  26. RREETTUURRNN VVAALLUUEESS
  27.      The ssttrrttoodd() function returns the converted value, if any.
  28.  
  29.      If _e_n_d_p_t_r is not NULL, a pointer to the character after the last charac¡
  30.      ter used in the conversion is stored in the location referenced by
  31.      _e_n_d_p_t_r.
  32.  
  33.      If no conversion is performed, zero is returned and the value of _n_p_t_r is
  34.      stored in the location referenced by _e_n_d_p_t_r.
  35.  
  36.      If the correct value would cause overflow, plus or minus HUGE_VAL is re¡
  37.      turned (according to the sign of the value), and ERANGE is stored in
  38.      _e_r_r_n_o. If the correct value would cause underflow, zero is returned and
  39.      ERANGE is stored in _e_r_r_n_o.
  40.  
  41. EERRRROORRSS
  42.      [ERANGE]  Overflow or underflow occurred.
  43.  
  44. SSEEEE AALLSSOO
  45.      atof(3),  atoi(3),  atol(3),  strtol(3),  strtoul(3)
  46.  
  47. SSTTAANNDDAARRDDSS
  48.      The ssttrrttoodd() function conforms to ANSI C3.159¡1989 (``ANSI C'').
  49.  
  50. BBUUGGSS
  51.      This manual page represents intent instead of actual practice.  The
  52.      ssttrrttoodd() function is not currently available.
  53.  
  54. BSD Experimental                 June 29, 1991                               1
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.